Inside Macintosh: QuickDraw GX Graphics /

Chapter 3 - Geometric Styles / Geometric Styles Reference

Functions / Getting and Setting Joins

GXSetStyleJoin

You can use the GXSetStyleJoin function to change a style object's join information.

void GXSetStyleJoin(gxStyle target, const gxJoinRecord *join);

target

A reference to the style object whose join information you want to change.

join

A pointer to the new join information.

DESCRIPTION

The GXSetStyleJoin function replaces the join information in the style object specified by the target parameter with the join information specified in the join parameter. You use the gxJoinRecord structure to provide join information.

Passing nil for the join parameter indicates that you want no join shape and QuickDraw GX removes any join information from the target style.

When you set a style's join property using this function, you are effectively changing the joins for all shapes that share the style.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
style_is_nil
parameter_out_of_range	(debugging version)
empty_shape_not_allowed	(debugging version)
ignorePlatformShape_not_allowed	(debugging version)
illegal_type_for_shape	(debugging version)
nil_style_in_glyph_not_allowed	(debugging version)
complex_glyph_style_not_allowed	(debugging version)
shapeFill_not_allowed	(debugging version)
Notices (debugging version)
join_type_already_set
tags_in_shape_ignored

SEE ALSO

For a discussion of joins, see "Joins" on page 3-25.

For examples of adding joins to shapes, see "Adding Joins to a Shape" on page 3-61 and "Adding Standard Joins to a Shape" on page 3-64.

For a discussion of the gxJoinRecord structure and a description of what types of shapes you can use as join shapes, see "The Join Structure" on page 3-101.

To retrieve join information from a style object, use the GXGetStyleJoin function, which is described on page 3-129.

To retrieve join information from a style object associated with a particular shape, use the GXGetShapeJoin function, which is described in the next section.

To specify join information for a style object associated with a particular shape, use the GXSetShapeJoin function, which is described on page 3-133.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help